How To Add a Device to RANCID 


These instructions will cover how to add a new network device to be used by RANCID. 

Default Network Device username: rancid 

Default Network Device password: COnflgM@nageMent 

Default Access Method: SSH 

Configure Network Device 

1. (config)# username rancid privilege 15 secret C0nflgM@nageMent 

Configure RANCID Server for New Network Device 

For the examples given in these instructions, the IP address 192.168.128.14 is used. You can substitute 
this IP address with your network device's IP address. 

1. Add network device to device list 

a) $ sudo vi /usr/local/rancid/var/networking/router . db 

• The format is: <IP address>;<manufacturer>;<status> 

• For example: 

192 . 168 . 128 . 14 ; cisco ; up 

2. Edit the RANCID rlogin configuration file 

a) If the device uses a different username, password, or access method (telnet vs SSH), then 
you need to add entry for that device. If the network device uses the default credentials and 
access method listed at the beginning of this document, then you do not need to edit this 
file. 

b) $ sudo vi /usr/local/rancid/ . cloginrc 

• For example if device 192.168.128.12 uses telnet and a different username/password, 
add the following lines: 

add user 192.168.128.12 {billy} 

add password 192.168.128.12 {userpassword} {enablepassword} 

add method 192.168.128.12 {telnet} 

c) Be sure to add the user, password, and method before the default entries. The default entries 
are the ones that use a wildcard for the hostname. For example, “add password * 
{COnflgM@nageMent} {COnflgM@nageMent}” is the default password entry. 

3. Verify that you can log in to the network device using the credentials you provided in the 
config. 

a) $ su - rancid 
b) Password: rancid 

c) $ bin/clogin 192.168.128.14 

d) You should see the login process run for your device and end up at the enable prompt. You 
may exit out from this prompt. 

4. Run rancid 

a) $ /usr/local/rancid/bin/rancid-run 

b) This will run for a few seconds. If successful, you should see a file named '192.168.128.14' 
(your network device) in the directory '/usr/local/rancid/var/networking/configs'. This file 
will contain the config of your device. 

c) $ cat /usr/local/rancid/var/networking/configs/192 . 168 . 128 . 14 

d) Confirm that the output of the previous command appears like that of your network device's 
running-configuration. 

5. Verify that the configuration file was added to CVS 

a) Open a Web Browser and go to http://10.9.9.70/viewvc/networking/configs/ 

b) You should see a listing with your device's IP address. If you click on the link, you should 



be able to view your device's configuration file. 


Troubleshooting 

SSH Host Key Verification Failed 

If you receive this error, it is probably that an IP address changed. To fix this, you need to remove the 
SSH key from the known Jiosts files. This can be done with the following command: 

$ ssh-keygen -R "<IP Address>" 



